home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / win_m_p / pwez51.zip / QUICKREF.DOC < prev    next >
Text File  |  1992-04-01  |  22KB  |  791 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                              Quick Reference Guide
  27.                            For use with WINDOWS R-E-Z
  28.                        QuickBasic 4.++ and BASIC 7.+ (PDS)
  29.                                  Version 5.10
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                              Copyright (c) 1988 - 1992 by:
  48.                              CONNECT Software
  49.                              All rights reserved
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                        ( See WIND_REZ.DOC for details. )
  58.            ( All routines are sub-routines unless noted otherwise. )
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.     =====================================================================
  70.                          Window Management System
  71.     =====================================================================
  72.  
  73.     CHNGWIND (W%)
  74.         Changes the active window to a new window.
  75.  
  76.         W% is the new active window number.   ( 1 to 20 )
  77.     --------------------------------------------------------------------
  78.  
  79.     CLRWIND
  80.         Clears the interior of the active window.
  81.     --------------------------------------------------------------------
  82.  
  83.     DELWIND (W%)
  84.         Deletes a saved window from window memory.
  85.  
  86.         W% is the window number to delete.    ( 1 to 20 )
  87.     --------------------------------------------------------------------
  88.  
  89.     LINEW (ROW%, TYP%)
  90.         Prints, or erases, a horizontal line in the active window.
  91.  
  92.         ROW% is the row in the window in which the line will print.
  93.         TYP% = 1 for single line, 2 for double line, 0 to erase a line.
  94.     --------------------------------------------------------------------
  95.  
  96.     MAKEWIND (W%, TITLE$, TR%, LC%, WD%, NR%, ATTR%, BORD%)
  97.         Makes a window and optionally saves a windowed area.
  98.  
  99.         W% is the assigned window number.  ( 0 to 20 )  "0" is not saved.
  100.         TITLE$ is the window's title.
  101.         TR% is the window's top row.       ( 1 to 23 or 100 )
  102.         LC% is the window's left column.   ( 1 to 78 or 100 )
  103.         WD% is the window's width.         ( 3 to 80 )
  104.         NR% is the number of rows.         ( 3 to 25 )
  105.         ATTR% is the window's color designation.  ( 0 to 255 )
  106.         BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
  107.                40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
  108.     --------------------------------------------------------------------
  109.  
  110.     NEWCOLOR (ATTR%)
  111.         Changes the "print-to" color of the active window.
  112.  
  113.         ATTR% is the new "print-to" color. ( 0 to 255 )
  114.     --------------------------------------------------------------------
  115.  
  116.     PRINTW (TEXT$, ROW%, COL%)
  117.         Prints text in the active window.
  118.  
  119.         TEXT$ is the text to print in the active window.
  120.         ROW% is the row in the window in which the text will print.
  121.         COL% is the column in the window where the text print starts .
  122.     --------------------------------------------------------------------
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                      1
  129.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.     =====================================================================
  136.                      Window Management System - Cont.
  137.     =====================================================================
  138.  
  139.     RESAVE
  140.         Saves the active window and interior of same in window memory.
  141.         Replaces the area covered by the active window in window memory.
  142.     --------------------------------------------------------------------
  143.  
  144.     RSTRWIND (W%, DELFLAG%)
  145.         Restores a window from window memory to the display.
  146.  
  147.         W% is the window number to restore.    ( 1 to 20 )
  148.         DELFLAG% = 1 to remove the window (W%) from window memory.
  149.                    0 to leave the window (W%) in window memory.
  150.     --------------------------------------------------------------------
  151.  
  152.     SAVEWIND (W%, TR%, LC%, WD%, NR%)
  153.         Saves an area from the display to window memory.
  154.  
  155.         W% is the window area's assigned number.  ( 1 to 20 )
  156.         TR% is the top row.                       ( 1 to 23 or 100 )
  157.         LC% is the left column.                   ( 1 to 78 or 100 )
  158.         WD% is the width.                         ( 3 to 80 )
  159.         NR% is the number of rows.                ( 3 to 25 )
  160.     --------------------------------------------------------------------
  161.  
  162.     SETWIND (FAST%, SND%, SHAD%)
  163.         Sets window memory, sound, and display update speed.
  164.  
  165.         FAST% = 1 for fast screen updates, 0 for slow CGA screen updates.
  166.         SND% = 1 for "click", 2 for "beep", and 0 for no sound.
  167.         SHAD% is the window shadow color. ( 0 to 255 )
  168.     --------------------------------------------------------------------
  169.  
  170.     WAVAIL% (WINDOW%)     *** FUNCTION ***
  171.         Returns 1 if a window is availaible, 0 if it is not available.
  172.  
  173.         WINDOW% is the window number. ( 1 to 25 )
  174.     --------------------------------------------------------------------
  175.  
  176.     WINDSTATUS
  177.         Display the status of windows saved in window memory.
  178.     --------------------------------------------------------------------
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                      2
  195.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  196.  
  197.  
  198.  
  199.  
  200.  
  201.     =====================================================================
  202.                              Pulldown Windows
  203.     =====================================================================
  204.  
  205.     CHNGPULL (BARITEM%, WINDITEM%, ATTR%)
  206.         Makes a pulldown window selection active or inactive.
  207.  
  208.         BARITEM% is the number of the pulldown menu bar selection.
  209.         WINDITEM% is the number of the pulldown window selection.
  210.         ATTR% = 0 for active selection with original color.
  211.                 1 to 127 for inactive selection with new color.
  212.  
  213.     --------------------------------------------------------------------
  214.  
  215.     SETPULL (TR%, LC%, WD%, PWIND$() )
  216.         Set up routine for pulldown windows
  217.  
  218.         TR% is the top row of the menubar.    ( 1 to 21 )
  219.         LC% is the left column position of the menubar. ( 1 to 73 )
  220.         WD% the menubar's width.  ( Maximum of 81 - LC% )
  221.         PWIND$() is the array holding the data for the pulldown menubar,
  222.                  menubar's info-line, and pulldown window's selections.
  223.  
  224.     --------------------------------------------------------------------
  225.  
  226.     PULLDOWN (INFO$(),MENUBAR%,WINDITEM%,EXIT$,RKEY%,ATTR%,KEYATTR%,BRDR%)
  227.         Places user in the pulldown window environment.
  228.  
  229.         INFO$() holds the pulldown window's selections info-line data.
  230.         MENUBAR% is the selected menu bar item.
  231.         WINDITEM% is the selected pulldown window item.
  232.         EXIT$ sets the exit keys.
  233.         RKEY% represents the key pressed, which caused the exit.
  234.         ATTR% is the color for the pulldown windows.   ( 1 to 127 )
  235.         KEYATTR% is the color for the key characters.  ( 1 to 127 )
  236.         BRDR% is the border designation. ( 0,1,2,10,11,12)
  237.  
  238.     --------------------------------------------------------------------
  239.  
  240.     RSTRPULL ( RSTRMENUBAR% )
  241.         Deactivates the active pulldown window.  Restores the display
  242.         area under the active pulldown window, optionally restoring
  243.         the area under the menubar also.
  244.  
  245.         RSTRMENUBAR% is set to 1 to restore the display area under
  246.                      the menubar, 0 does not restore the area.
  247.  
  248.     --------------------------------------------------------------------
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                      3
  261.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.     =====================================================================
  268.                               Scroll Windows
  269.     =====================================================================
  270.  
  271.     MARKED% (RTRN$, START%)   *** FUNCTION ***
  272.         Decodes marked items from a "mark" scroll window.
  273.  
  274.         RTRN$ is the string representing items marked in a scroll window.
  275.         START% is the position in which to start the decoding in RTRN$.
  276.     --------------------------------------------------------------------
  277.  
  278.     SETSCRL (ISARROW%, NOHI%, TAGCOLOR%)
  279.         Changes default settings for calls to routine SCRLWIND.
  280.  
  281.         ISARROW% = 1 for direction arrow, 0 for no direction arrow.
  282.         NOHI% = 0 to display high intensity characters normally.
  283.                 1 to display as inverse video for PULLDOWN & SCRLWIND.
  284.         TAGCOLOR% sets the color for the "mark" arrow. (0 to 15)
  285.     --------------------------------------------------------------------
  286.  
  287.     SCRLWIND (LIST$(),INFO$(),TL$,ENTRIES%,KIND$,RTRN%,LI%,FC%,RKEY%,
  288.               KEYATTR%)
  289.  
  290.     Note: The above call to SCRLWIND must be typed one line in the
  291.           QB/QBX environment.
  292.  
  293.         Places a scrollable list in a window previously made by MAKEWIND.
  294.  
  295.         LIST$() is the list to place in the scroll window.
  296.         INFO$() is the scroll window's selections info-line data.
  297.         TL$ is the top line message for scroll windows with title boxes.
  298.         ENTRIES% is the number of items in LIST$().
  299.         KIND$ sets the type of scroll windows on entry to SCRLWIND.
  300.               "A"=autoexit   "M"=multiple mark    "S"=single mark
  301.               "V","SV"=view/single-mark view      "L"=list only
  302.               Holds coded data for "mark" scroll windows on exit.
  303.         RTRN% sets the highlighted setection on entry.  On exit, it
  304.               returns the sequential item selected from the scroll window.
  305.         LI% sets the interior row position the selected entry will occupy
  306.             on entry.  On exit, it returns the row position occupied by
  307.             the highlighted entry.
  308.         FC% sets the offset from start of the strings ( entries ) to print
  309.             in the first column of virtual scroll window.   On exit, it
  310.             returns the offset from the start of the strings ( entries )
  311.             occuping the first column in virtual scroll windows.
  312.         KEYATTR% is the color for the key characters.  ( 0 to 127 )
  313.                  0 = virtual scroll windows if any selections are
  314.                      wider the the window's width minus 4.
  315.                  1 to 127 = non-virtual scroll window
  316.     --------------------------------------------------------------------
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                      4
  327.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.     =====================================================================
  334.                           Scroll Windows - cont.
  335.     =====================================================================
  336.  
  337.  
  338.  
  339.     B4SCRL ( EXIT$, MARK$ )
  340.         Provides addition options for a subsequent call to SCRLWIND.
  341.  
  342.         EXIT$ sets those keys or circumstances which will exit SCRLWIND.
  343.               ( Any combination of "0123456789ERIDX" )
  344.         MARK$ allows selections in a scroll window to be marked on entry.
  345.     --------------------------------------------------------------------
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                      5
  393.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.     =====================================================================
  400.                               Input Routines
  401.     =====================================================================
  402.  
  403.     INPTINIT ( DATEFORMAT%, ISDOT%, EXIT$ )
  404.         Initializes input memory for routines INPTWIND an MULTINPT.
  405.  
  406.         DATEFROMAT% sets the allowable date format. ( 1 to 5 )
  407.         ISDOT% equals 1 for a period decimal point, 0 for a comma.
  408.         EXIT$ sets the exit keys for routine INPTWIND and may equal
  409.               any combination of "0123456789UDER".
  410.  
  411.     ---------------------------------------------------------------------
  412.  
  413.     INPTWIND (P$, CODE$, TR%, LC%, WD%, ATTR%, RES$, RTRN$, RKEY%, BRDR%)
  414.         Places an input window on the display.  Waits for user input.
  415.  
  416.         P$ is the prompt displayed for the input window.
  417.         CODE$ is the code for the type of allowable input.
  418.         TR% is the top row.                      ( 1 to 25 or 100 )
  419.         LC% is the left column.                  ( 1 to 79 or 100 )
  420.         WD% is the width of the input field.
  421.         ATTR% is the color for the input window.
  422.         RES$ restricts input to user defined characters.
  423.         RTRN$ is the text entered by the user in the input field.
  424.         RKEY% represents the "exit key". 1 to 13, 27
  425.         BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
  426.                40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
  427.  
  428.  
  429.     --------------------------------------------------------------------
  430.  
  431.     MULTINPT (SCRN%, TOFLD%, CODE$, AUTOEXIT%, RKEY%, RTRN$() )
  432.         Displays input fields and waits for user entry.
  433.  
  434.         SCRN% is the assigned multi-field input screen to display.
  435.         TOFLD% is the active field when entering or exiting MULTINPT.
  436.         CODE$ is set to "VIEW" for view only, "U" to change several
  437.               field movement keys to follow user defined order.
  438.         AUTOEXIT%  sets single field update on entry.  Holds zero or
  439.                   the the auto-exit field number which is being
  440.                   exited when MULTINPT exits.
  441.         RKEY% holds the designation for the key which exited MULTINPT.
  442.         RTRN$() is the array holding each input field's data.
  443.  
  444.     --------------------------------------------------------------------
  445.  
  446.     RSTRINPT ( RESTOREFLAG% )
  447.         Deactivates the active input window optionally restoring the
  448.         display area under same.
  449.  
  450.         RESTOREFLAG% is set to 1 to restore the display area under the
  451.                      active input window, 0 to not restore it.
  452.  
  453.      -------------------------------------------------------------------
  454.  
  455.  
  456.  
  457.  
  458.                                      6
  459.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  460.  
  461.  
  462.  
  463.  
  464.  
  465.     =====================================================================
  466.                           Input Routines - Cont.
  467.     =====================================================================
  468.  
  469.     SETINPT (SCRN%, COLWIDE%, EXIT$, INPT%(), INPT$(), ACTCOL%)
  470.         Set up routine for a multi-field input screen. ( MULTINPT )
  471.  
  472.         SCRN% is the multi-field input screen designation.  (1 - 10).
  473.         COLWIDE% is the display width for the multi-field input screen.
  474.         EXIT$ represents the allowable keys which will exit MULTINPT.
  475.         INPT%() is a array holding data for each input field type.
  476.         INPT$() is a array holding data for restricted input fields.
  477.         ACTCOL% is the active field's color.  ( 0 to 255 )
  478.  
  479.     --------------------------------------------------------------------
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                      7
  525.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  526.  
  527.  
  528.  
  529.  
  530.  
  531.     =====================================================================
  532.                             Directory Routines
  533.     =====================================================================
  534.  
  535.     DISKSIZE (DRIVE%, SIZE&, FREE&)
  536.         Finds a disk size and free space in bytes.
  537.  
  538.         DRIVE% represents the disk. 1=A, 2=B etc.
  539.         SIZE& is the total number of bytes of storage capacity.
  540.         FREE& is the unused bytes.
  541.  
  542.     --------------------------------------------------------------------
  543.  
  544.     FINDDIR (PATH$, TYP$. FILE%)
  545.         Places directory listing of any path in a pre-defined array.
  546.  
  547.         PATH$ is the path to search for the directory listing.
  548.         TYP$ specifies file attributes to include in the directory search.
  549.         FILE% holds the number of files found in the directory search.
  550.  
  551.     --------------------------------------------------------------------
  552.  
  553.     FINDPATH (PATH$)
  554.         Returns the current path.
  555.  
  556.         PATH$ is the current drive and path.  ( DRIVE:\SUB-DIR.... )
  557.  
  558.     --------------------------------------------------------------------
  559.  
  560.     GETDISK (DRIVE%)
  561.         Returns the current ( default ) drive.
  562.  
  563.         DRIVE% is the drive. 1=A, 2=B, etc.
  564.  
  565.     --------------------------------------------------------------------
  566.  
  567.     SETDISK (DRIVE%, BADFLAG%)
  568.         Sets the default drive.
  569.  
  570.         DRIVE% is the drive. 1=A, 2=B, etc.
  571.         BADFLAG% = 1 if an attempt was made to set an invalid drive.
  572.  
  573.     --------------------------------------------------------------------
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                      8
  591.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  592.  
  593.  
  594.  
  595.  
  596.  
  597.     =====================================================================
  598.                         Keyboard and Mouse Routines
  599.     =====================================================================
  600.  
  601.     KEYMOUSE% ** FUNCTION **
  602.         Returns the ASCII/IBM or extended value of the key or mouse button
  603.         pressed, or the value for mouse movement.
  604.  
  605.     ---------------------------------------------------------------------
  606.  
  607.     MBUTTONS (LBUTTON%, RBUTTON%)
  608.         Defines the values for the left and right mouse buttons.  These
  609.         are the values returned by function KEYMOUSE%
  610.  
  611.         LBUTTON% is the value for the left mouse button.  ( 1 to 255 )
  612.         RBUTTON% is the value for the right mouse button. ( 1 to 255 )
  613.  
  614.     ---------------------------------------------------------------------
  615.  
  616.     MOUSEON (ISON%)
  617.         Turns the mouse on or off, or disables motion detection.
  618.  
  619.         ISON% = 0 for mouse off, 1 for mouse on, 2 for no motion
  620.                 detection.
  621.     ---------------------------------------------------------------------
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                      9
  657.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  658.  
  659.  
  660.  
  661.  
  662.  
  663.     =====================================================================
  664.                             Info-line Routines
  665.     =====================================================================
  666.  
  667.     INFOLINE ( ROW%, LC%, WD%, ATTR% )
  668.         Turns on the info-line.  Saves the display area under same.
  669.  
  670.         ROW% is the row position of the info-line. (1 to 25)
  671.         LC% is the left column position of the info-line (1 to 80)
  672.         WD% is the width of the info-line (1 to 80)
  673.             ( LC% + WD% must equal less than 82 )
  674.         ATTR% is the info-line's color. (1 to 127)
  675.  
  676.     ---------------------------------------------------------------------
  677.  
  678.  
  679.     INFOFIXED ( FIXED$ )
  680.         Defines a fixed info-string, which prints on calls to PRINTINFO.
  681.  
  682.         FIXED$ is the fixed info-string. It will print before any string
  683.                specified in PRINTINFO.
  684.  
  685.     ---------------------------------------------------------------------
  686.  
  687.     PRINTINFO ( MESSAGE$ )
  688.        Prints a message in the info-line.
  689.  
  690.        MESSAGE$ is the message.  It is appended to the fixed info-string
  691.                 if one exists.
  692.  
  693.     ---------------------------------------------------------------------
  694.  
  695.     RSTRINFO ( OFFFLAG% )
  696.        Restores the display area under the info-line. Optionally turns
  697.        off the info-line.
  698.  
  699.        OFFFLAG% is set to one to turn off the info-line, 0 to leave on.
  700.  
  701.     ---------------------------------------------------------------------
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                      10
  723.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  724.  
  725.  
  726.  
  727.  
  728.  
  729.     =====================================================================
  730.                               Other Routines
  731.     =====================================================================
  732.  
  733.     GETANS (PROMPT$, CHOICE$, ANS$, TR%, LC%, ATTR%, BRDR%)
  734.         Displays a windowed prompt. Waits for a single key user response.
  735.  
  736.         PROMPT$ is the prompt to place in the get answer window.
  737.         CHOICE$ represents the allowable keys GETANS will recognize.
  738.         ANS$ sets the mode of operation for GETANS on entry.  If ANS$ = ""
  739.              on entry GETANS exits as soon as a valid key is pressed.  If
  740.              ANS$ equals any character the character is displayed on
  741.              entry.  ENTER must be pressed to exit.  On exit, ANS$ returns
  742.              the character (key) selected by the user.
  743.         TR% is the top row of the get answer window.    ( 1 to 23 or 100 )
  744.         LC% is the left column of the get answer window.( 1 to 76 or 100 )
  745.         ATTR% is the color of the get answer window.    ( 1 to 255 )
  746.         BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
  747.               40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
  748.  
  749.     --------------------------------------------------------------------
  750.  
  751.     DOSOUND
  752.         Makes the default sound.
  753.  
  754.     --------------------------------------------------------------------
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                      11
  789.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  790.  
  791.